Welcome to Source Printer. Copyright 1994 David J. Mikelson This is version 1.0 (circa 17 September 1994) Online help is available via the Windows help file SRCPRN10.HLP. Context sensitive help while running Source Printer is available by pressing F1 at any time. Note that you can browse the SRCPRN10.HLP file without installing or running Source Printer by double clicking on it from File Manager. CONTENTS -------- What It Does Supported Programming Languages Disclaimer - Agreement About the Unregistered Version Installing Source Printer Uninstalling Source Printer Quick Start How To Register Ordering By Check Ordering Through Compuserve Order Form Ordering Through PsL (credit cards) Upgrading Contacting the Author WHAT IT DOES ------------ Source Printer prints your source code so that it is easier to read and follow. It does this by: Allowing you to specify different fonts for normal and commented code Expanding tabs properly Intelligently indenting and word wrapping each line when required Intelligently aligning columns and blocks of code Printing headers and/or footers if requested Source Printer can interpret comments for a number of programming languages. In addition, you can specify a user defined comment format to handle almost any programming language not supported. The programming languages supported by Source Printer include: .ASM Assembler source code .BAS Basic source code .C C source code .CBL Cobol source code .CPP C++ source code .FOR Fortran source code .H C,C++ include files .INC Pascal include files .LSP Lisp source code .PAS Pascal source code .POV Persistence of Vision Scene Files .PRG Clipper source code .??? User Defined Source Printer allows you to specify margins, tabstops, character spacing, and line spacing. It can print text from Window's Clipboard, and supports 'Drag and Drop' onto either its icon or main window. DISCLAIMER ---------- Prices below will be valid until 1 July 1995. Users of Source Printer must accept this disclaimer of warranty: Source Printer is supplied as is. The author disclaims all warranties, expressed or implied, including, without limitation, the warranties of merchantability and of fitness for any purpose. The author assumes no liability for damages, direct or consequential, which may result from the use of Source Printer. Source Printer is a 'shareware program' and is provided at no charge to the user for evaluation. Feel free to share the unregistered version with your friends, but please do not give it away altered or as part of another system. The essence of 'user-supported' software is to provide personal computer users with quality software without high prices, and yet to provide incentive for programmers to continue to develop new products. If you wish to register Source Printer, make a registration payment of US$ 10.00 (or US$ 15.00 if ordering through PsL) to David J. Mikelson (see How To Register). The registration fee will license one copy for use on any one computer at any one time. You must treat this software just like a book. An example is that this software may be used by any number of people and may be freely moved from one computer location to another, so long as there is no possibility of it being used at one location while it's being used at another. Just as a book cannot be read by two different persons at the same time. Site-License arrangements may be made by contacting David J. Mikelson (see Contacting the Author). Anyone distributing Source Printer for any kind of renumeration must first contact David J. Mikelson at the address given on the Order Form for authorization. You are encouraged to pass unregistered trial copies of Source Printer along to your friends for evaluation. Please encourage them to register their copy if they find that they can use it. ABOUT THE UNREGISTERED VERSION ------------------------------ Prices below will be valid until 1 July 1995. I thought long and hard about whether or not to distribute unregistered trial copies of Source Printer in a fully functional form. In the end, for purely selfish reasons, I decided not to. Your interest in Source Printer probably means you are a programmer, and so perhaps you can relate to the many person-hours involved in writing something like Source Printer. Instead, I have tried to make the basic registration fee very reasonable, and I hope you agree that US$ 10.00 is reasonable. In its unregistered form, the only limitation is that you cannot print more than five pages from each source code file. You can of course break your big files up into many five page files, and print them that way, but I'm sort of hoping you'll get tired of that. On the other hand, if you only dabble with programming and your source files are generally less than five pages, then the unregistered version will serve you well, and you are welcome to continue using it for as long as you like (though you'll have to put up with the beg notices). Upon registration, you will be sent a personal registration number that will unlock the five page limitation. The same registration number will work with all future versions. See How To Register later. INSTALLING SOURCE PRINTER ------------------------- Make a subdirectory with a name of your choosing. The following assumes you have chosen a subdirectory called SRCPRN. Copy the following files to the SRCPRN subdirectory. Do not copy the supplied version of BWCC.DLL yet (if you are extracting Source Printer from an archive, do not extract BWCC.DLL yet). SRCPRN10.EXE SRCPRN10.HLP FINDBWCC.EXE README.TXT ORDERFRM.TXT To run Source Printer, the file BWCC.DLL needs to be in your Windows system subdirectory (like C:\WINDOWS\SYSTEM). (BWCC.DLL is part of Borland Windows Custom Controls (C) Copyright 1991-1993 by Borland International.) BWCC.DLL is a file that is used by many other Windows applications. There are several versions of it around, and it is not uncommon for some automated installation programs to replace a newer version that you may have on your hard disk with an older version. This usually doesn't cause any problems, but it is best to retain the latest version on your hard disk. The version of BWCC.DLL shipped with this copy of Source Printer is BWCC.DLL v 2.00. The file date is 21 October 1993 and the file size is 156,544 bytes. As far as I can tell, this is the latest version as of 17 September 1994. I have included a little utility called FINDBWCC.EXE that you may want to run before copying the version of BWCC.DLL that comes with Source Printer to your hard disk. This is a Windows program that can be run by double clicking on it in File Manager, or by selecting File - Run from Program Manager. (Make sure you have not accidentally extracted the version of BWCC.DLL that came with Source Printer to the same directory that FINDBWCC.EXE is in, or FINDBWCC.EXE will find only that version, and that is not what we want to do). If you run FINDBWCC.EXE and BWCC.DLL cannot be found: File Manager will throw up a message box saying something like 'File Manager cannot find the specified file (or one of its components) ...' Program Manager will throw up a message box saying something like 'File Error - cannot find BWCC.DLL...' followed by a message box saying something like 'Cannot find file FINDBWCC.EXE or one of its components...'. In either of these cases, it means you do not have BWCC.DLL on your hard disk (where Windows can find it). So, you should now proceed to copy the version of BWCC.DLL that is supplied with Source PrinterBWCCDLL_DFN to your Windows system subdirectory (like C:\WINDOWS\SYSTEM). If you run FINDBWCC.EXE and a copy of BWCC.DLL was found, FINDBWCC throws up a message box telling you what version of BWCC.DLL was found. If the version reported by FINDBWCC.EXE is less than 2.00, then you should now proceed to copy the version of BWCC.DLL that is supplied with Source Printer to your Windows system subdirectory (like C:\WINDOWS\SYSTEM). You should also ensure that this is the only version on your hard disk. For example, if you also have BWCC.DLL in your C:\WINDOWS subdirectory, you should delete or rename that copy. If FINDBWCC.EXE reports a version of BWCC.DLL greater than or equal to 2.00, then do not copy the version of BWCC.DLL that is supplied with Source Printer to your hard disk. When Source Printer is run for the first time, it will create a file called SRCPRN10.INI in Source Printer's subdirectory. This file is used on subsequent startups to set various parameters to whatever they were when you last exited Source Printer (like fonts, margins, preferences, etc.). The initial SRCPRN10.INI file that is created when Source Printer is first run contains reasonable defaults. The installation of Source Printer is now complete. If desired, you can create a new group or add Source Printer to an existing group by using the normal File Manager's drag and drop facilities or Program Manager's File - New - Group/Item commands. UNINSTALLING SOURCE PRINTER --------------------------- Erase the following files from whatever subdirectory you installed Source Printer into. SRCPRN10.EXE SRCPRN10.HLP SRCPRN10.INI FINDBWCC.EXE README.TXT ORDERFRM.TXT If you created a Source Printer icon in Program Manager, delete that icon. Source Printer came with a copy of BWCC.DLL, which should be in your main Windows system subdirectory (like C:\WINDOWS\SYSTEM). However, there are many other programs that require BWCC.DLL to run, so, unless you are sure that no other programs you have require BWCC.DLL, do not delete this file. Source Printer itself makes no changes to any of the Window's .INI files. However, if you used File Manager to associate any file extensions with Source Printer, there may be references to Source Printer in some of your Windows .INI files. QUICK START ----------- To print something with Source Printer right now: If you have not already done so, install Source Printer. When you run Source Printer for the very first time, the various settings suggested below will have already been selected by default. Any of the settings below can be changed later. Any changes will be automatically saved for your next Source Printer session. For the Quick-Start, just use the ones suggested. See What It Does for a list of the programming languages that Source Printer supports. Double click on SRCPRN10.EXE from File Manager, use File - Run from Program Manager, or, if you have installed a Source Printer icon in Program Manager, double click on that. Click on the Select Files button on Source Printer's main window. This brings up a file selection dialog box from which you select one or more source code files to place in the file list on Source Printer's main window for printing. Hold the Ctrl key down while clicking on the file names to select more than one file. Select Format - Fonts from the main menu. Place a check-mark in the 'Allow Fixed pitch only' box. Set the Line Spacing to 1.0. Set the Char Spacing to 1.0. Click on the Change normal code font button and select Courier New, 10 pt, Regular. Click on the Change commented code font button and select Courier New, 10 pt, Bold. Select Format - Header/Footer from the main menu. Place check-marks in Number Pages, Bottom, Right. Place check-marks in Print Filename, Top, Left. Place check-marks in Print Date, Top, Right. Select Use Today's Date. Place check-marks in Header separator and Footer separator. Select Format - Margins/Tabs from the main menu. Set all margins to 1.0 inch, but make sure these are larger than the minimum margins that will be shown for your printer. Set the tab stops to 3. The current page orientation (Portrait or Landscape) is shown in Source Printer's main window. To change this, select File - Print Setup from the main menu. When Source Printer first starts up, it configures itself to use the default printer you have specified through Windows' Control Panel. Click the Print button. HOW TO REGISTER --------------- Prices below will be valid until 1 July 1995. You can register in three ways: 1) By ordering through Compuserve's Shareware Registration service Log onto Compuserve and GO SWREG. Follow the prompts. Source Printer's Compuserve registration ID is 3555. When you register this way, you leave your Compuserve ID with SWREG. Your registration is charged to your Compuserve account. SWREG then notifies me via e-mail that you have registered. I then e-mail you your registration number. 2) By sending me a check directly Print the file ORDERFRM.TXT 3) By credit card through PsL (Public (software) Library). Note that you cannot upgrade through PsL. See Ordering through PsL. Ordering through Compuserve's SWREG service is the preferred method. It is simpler for me and quicker for you. But there is absolutely nothing wrong with the other two methods. The basic registration fee for Source Printer is US$ 10.00 per copy. However, there is an exception: If you must order via credit card, then you must order through PsL (Public (software) Library). In this case, I must ask a registration fee of US$ 15.00 to cover additional costs to me. Upgrades are not available through PsL. For the basic registration fee, you will be sent a registration number to unlock the copy you currently have. In order to keep the cost down, I am not sending disks automatically. Please strive to get the latest version from the Microsoft Windows Shareware Forum (GO WINSHARE) (Programming Related library) on Compuserve (see Upgrading). SOURCE PRINTER ORDER FORM ------------------------- If ordering by check only, print the order form by printing the file ORDERFRM.TXT from DOS. Or, if viewing the Windows SRCPRN10.HLP file, select the topic 'Order Form' and select 'File - Print Topic' from the menu bar. Do not use this form to order through Compuserve or PsL. The order form is duplicated below. ------------------------------------------------------------------- Prices below will be valid until 1 July 1995. Send this form with a check payable to Dave Mikelson to: Dave Mikelson 370 Vester Sted Solvang, CA 93463 U.S.A. Payments must be made in US dollars drawn on a US bank, or you can send international postal money orders in US dollars. Name: ______________________________________________________________ Company: ___________________________________________________________ Address: ___________________________________________________________ City: ______________________________________________________________ Country: _________________________Post Code: _______________________ Day Phone: ______________________ Eve.Phone ________________________ Electronic Mail Address: ___________________________________________ Where did you hear about or download Source Printer from:___________ Version of Source Printer You Have: ________________________________ Source Printer Registration Number (if upgrading and requesting disk) (Name above must be exact registered name) _________________________ Costs: Basic Registration (receive reg number only - no disk**): US$ 10.00 Receive Upgrade disk**** (See Upgrading) US$ 2.00 California residents must add 7.25% sales tax. Disk Size: Hi Den 3-1/2 (1.4 Mb)____ Hi Den 5-1/2 (1.2 Mb) ____ ** If you are registering for the first time, and if I have completed a later version than the one you have, I will send you a disk with the later version on it for no extra charge. **** For registered users only who cannot download from Compuserve or other BBS. ------------------------------------------------------------------- ORDERING THROUGH PSL -------------------- Use PsL only if you must order by credit card. Upgrades are not available through PsL (see Upgrading). PsL takes orders only. Any questions about the status of the order, refunds, registration options, product details, technical support, volume discounts, dealer pricing, site licenses, etc. must be directed: By post, to: Dave Mikelson 370 Vester Sted Solvang, CA 93463 U.S.A. or From Compuserve to: TO: DAVE MIKELSON, 100141,1006 or From Internet: To: 100141.1006@compuserve.com If you order through PsL, the basic registration fee is US$ 15.00. This is because there are additional costs to me. Note that you can register for only $US 10.00 if you use Compuserve's shareware registration service (GO SWREG) (see How To Register) or if you send a check directly to me (see Order Form). Source Printer's PsL Product ID is 11599. PsL is short for 'Public (software) Library'. CREDIT CARD ORDERS ONLY You can order with MC, Visa, Amex, or Discovery from Public (software) Library by calling 800-2424-PsL or 713-524-6394 or by FAX to 713-524-6398 or by CIS Email to 71355,470. You can also mail credit card orders to PsL at P.O. Box 35705, Houston, Texas, 77235-5705. THE ABOVE NUMBERS ARE FOR ORDERS ONLY Any questions about the status of the shipment of the order, refunds, registration options, product details, technical support, volume discounts, dealer pricing, site licenses, etc. must be directed to the author's (Dave Mikelson) contacts above. PsL will notify me the day of your order, and I will dispatch your Source Printer registration number directly to you. Once again, if you have a Compserve account already, use GO SWREG instead of PsL and save yourself US$ 5.00. UPGRADING --------- Prices below will be valid until 1 July 1995. If you are a registered user and have access to Compuserve, upgrades are free. The latest version of Source Printer should always be available through Compuserve in the 'Microsoft Windows Shareware Forum' (GO WINSHARE) in the 'Programming Related' library. Look for a file called SRCPRNXX.ZIP, where XX will indicate the version number (10 means 1.0). Note that you cannot upgrade through Compuserve's Shareware Registration Service (SWREG). SWREG is for initial registration only. The latest version as of 17 September 1994 is version 1.0, and is distributed as SRCPRN10.ZIP. Registered users will be able to use their registration number to unlock all future versions. You cannot upgrade through the Compuserve Shareware Registration Service (SWREG) or by credit card. If you are a registered user and only if you know that a later version than the one you have exists but you do not have access to Compuserve, then: Registered users can receive an upgrade disk for US$ 2.00. You must send a check to me directly. Include your registration name and number on all correspondence. (see Order Form). CONTACTING THE AUTHOR --------------------- The easiest way to reach me is to leave me mail on Compuserve. From Compuserve: TO: DAVE MIKELSON, 100141,1006 From Internet: To: 100141.1006@compuserve.com (please pay the postage yourself) Alternatively, write to: Dave Mikelson 370 Vester Sted Solvang, CA 93463 U.S.A. DISTRIBUTING SOURCE PRINTER --------------------------- You are encouraged to pass unregistered trial copies of Source Printer along to your friends for evaluation. If you do so, you must provide them with the entire set of Source Printer files: SRCPRN10.EXE SRCPRN10.HLP README.TXT ORDERFRM.TXT FINDBWCC.EXE BWCC.DLL FILE_ID.DIZ